Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Editing Movies / Undo for Movies

NewMovieEditState

You can create an edit state by calling the NewMovieEditState function. This function creates an edit state that contains all the information describing a movie's content, including the current selection, the movie's tracks, and the media data associated with those tracks.

Note

You must dispose of a movie's edit states before you dispose of the movie itself. Use the DisposeMovieEditState function (described on page 2-240) to dispose of an edit state.

pascal MovieEditState NewMovieEditState (Movie theMovie); 

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

DESCRIPTION

The NewMovieEditState function returns a movie edit state identifier. You can use this identifier with other Movie Toolbox edit state functions, such as UseMovieEditState (described in the next section). If this function could not create the edit state, it sets this returned identifier to nil.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

Memory Manager errors